home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / bbs / ho51.zip / install.doc < prev    next >
Text File  |  1994-09-26  |  15KB  |  401 lines
  1.  
  2.  
  3.                The Quick & Easy Install manual                 Page 1
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                         _______
  10.                    ____|__     |               (R)
  11.                 --|       |    |-------------------
  12.                   |   ____|__  |  Association of
  13.                   |  |       |_|  Shareware
  14.                   |__|   o   |    Professionals
  15.                 -----|   |   |---------------------
  16.                      |___|___|    Member
  17.  
  18.  
  19.  
  20.           September, 1994
  21.  
  22.  
  23.           Install  is  designed  to  allow  you  to install and run your
  24.           software including  demonstration  programs,  and  maintenance
  25.           software.   You  may also use it as a general install program,
  26.           to setup software that  you  only  use  occasionally  and  the
  27.           like.    Install   stores  its  help  information  and  script
  28.           instructions in the INSTALL.DBF and INSTALL.DBT Xbase database
  29.           files.  You can edit the help by  tapping  F7  instead  of  F1
  30.           -Help  while running install or you can start install with the
  31.           "EDIT" command line parameter.  Install always  looks  in  the
  32.           last  active, or undeleted, entry for its script instructions.
  33.           You  can  take  advantage  of  this   by   putting   alternate
  34.           installation   sets   in   other  dbase  deleted  entries  and
  35.           undeleting them for  particular  disk  distributions.    Don't
  36.           leave the last entry blank, or install will yell at you.  This
  37.           installer was originally setup for the TeleShare remote access
  38.           package,  but  this release matches the Hands On remote access
  39.           package.  Some of the Teleshare features  are  not  used  with
  40.           Hands  On,  but  they  are  retained and may become useful for
  41.           particular installations.
  42.  
  43.           Command line parameters
  44.  
  45.           INSTALL [EDIT ADD MONO RECNO#]
  46.  
  47.           EDIT   - to edit the script database
  48.           ADD    - to add a new entry and edit the script database.
  49.           MONO   - to force monochrome screen output.
  50.  
  51.  
  52.           The install script language follows:
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                The Quick & Easy Install manual                 Page 2
  61.  
  62.  
  63.           # is used for comments.  Anything to  the  right  of  a  #  is
  64.           considered a comment.
  65.  
  66.           Every install script must start with the line.
  67.           "TELESHARE INSTALL SCRIPT"
  68.  
  69.           Otherwise  the installer might try to work over one of its own
  70.           help files, and snivel at you.
  71.  
  72.  
  73.           BROWSE somefile  to  browse  or  review  some  text  file  for
  74.           information.  It has a built-in search capability.
  75.  
  76.           CHANGEDISK  key_file To prompt to change to the next diskette,
  77.           and to check for the specified key file on the next disk.  You
  78.           can leave a space and add a message that will be displayed  in
  79.           place of  "Please  change  disks" after the key_file name.  Do
  80.           not use a zero length key_file name.
  81.  
  82.           CHANGEDISK peaches.exe Please change to the red disk.
  83.  
  84.           CLEAR to clear the screen.  This version  actually  calls  the
  85.           DOS CLS to ensure that the screen color/colour matches similar
  86.           DOS related commands that you may be using in association with
  87.           it.
  88.  
  89.           COMMAND  to  directly  run  programs  and  to pass commands to
  90.           command.com.  See the RUN and SWAP commands below.
  91.  
  92.           COPY - to allow copying of materials from the source to target
  93.           disk as in:
  94.           COPY file_1 file_2 file_3 etc
  95.  
  96.           The destination is the DIRECTORY provided earlier.
  97.  
  98.  
  99.           DIRECTORY - to supply a directory name for editing.
  100.  
  101.           ECHO like the DOS echo.  Anything that is  not  recognised  by
  102.           the  script  parser  is  simply  echoed to the screen, but any
  103.           spaces on the left side will be trimmed off.
  104.  
  105.           IF and END or ENDIF If is used with ADD-IN or BASIC, as in
  106.           IF  BASIC
  107.              # installation commands for the BASIC option
  108.              ...
  109.           ENDIF
  110.           IF ADD-IN
  111.              # installation commands for the ADD-IN option
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                The Quick & Easy Install manual                 Page 3
  118.  
  119.  
  120.              ...
  121.           END
  122.           if add-in basic
  123.              # to combine the partial installation options
  124.              ...
  125.           endif
  126.  
  127.           IF direct_install
  128.              # direct_install is a logical switch
  129.              # that becomes TRUE if the 'last file'
  130.              # is found at the start of the install
  131.              run save HOMENU.BAT
  132.              QUIT
  133.           ENDIF
  134.  
  135.           The final "END" or "ENDIF" is an implied "QUIT", so if you use
  136.           one of the two optional partial installation  options,  ensure
  137.           that the 'right stuff' is done before the "END".
  138.  
  139.           There is  no "IF ALL" to install everything.  If the option to
  140.           install everything is chosen, any "IF BASIC"  or  "IF  ADD-IN"
  141.           instruction sets are ignored.
  142.  
  143.           INSTALL  DIRECTORY  \HANDS_ON\  #  to  specify  the \HANDS_ON\
  144.           directory.
  145.  
  146.           INSTALL HEADER - This  allows  you  to  provide  an  alternate
  147.           header to replace the default message at the upper part of the
  148.           screen.  You may use up to 3 message or header lines.
  149.  
  150.           INSTALL  README  some_file  to  allow you to use any file name
  151.           instead of the default README.DOC name.  README.DOC is used in
  152.           place of README.1ST to make it easier to look up  a  group  of
  153.           manuals, ending in ".DOC", with various browsers.
  154.  
  155.           INSTALL  ADD-IN or BASIC - to specify that the distribution is
  156.           only a partial distribution.  The installer defaults to asking
  157.           if you want 1) A FULL distribution or 2) Only  the  REMOTE  or
  158.           the  HOST  (BASIC)  or 3) As an ADD-IN to another product like
  159.           bitcom.  Use one  of  these  command  options  to  bypass  the
  160.           prompting.
  161.  
  162.           QUIT - to instruct INSTALL to quit to DOS.
  163.  
  164.           QUIT_TO to  quit  and  run  another  program.  This version of
  165.           Install does  NOT  use  keyboard  stuffing  to  run  the  next
  166.           program, unlike  previous  releases.    When  you use "QUIT_TO
  167.           some_prog" the program swaps all but 2k of itself to disk  and
  168.           runs the  "some_prog".    It  then  swaps itself back in after
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                The Quick & Easy Install manual                 Page 4
  175.  
  176.  
  177.           running and immediately quits.
  178.  
  179.           LASTFILE to specify the last file in a disk set.  This  allows
  180.           the  installer  to  look  for  the last file and automatically
  181.           decide that the installation is a 'one disk' set.  This allows
  182.           you to use the same installation instruction script  for  360K
  183.           diskettes, 1.44M  diskettes,  and  BBS  type installation.  It
  184.           causes CHANGEDISK type  instructions  to  be  ignored.    eg.:
  185.           "LASTFILE lastdisk.zip".    The  Sept/94 update adds a logical
  186.           switch DIRECT_INSTALL that becomes True  if  the  LASTFILE  is
  187.           present  when  the  installer  reads  in the install script in
  188.           install.dbf.  You can use it with IF ... ENDIF as shown above,
  189.           most likely for installations from  files  downloaded  from  a
  190.           BBS.
  191.  
  192.           # if the 'lastfile' has been found this IF will be entered
  193.           IF direct_install
  194.             some stuff
  195.             ...
  196.             quit
  197.           ENDIF
  198.  
  199.           Please note that a side effect of the LASTFILE command is that
  200.           the  installer  logical  rule  base  goes  bonkers  if you use
  201.           LASTFILE and install a second  time  over  the  first  set  of
  202.           files, from  5  1/4"  diskettes.  It then decides that you are
  203.           actually installing from a 3  1/2"  diskette,  and  mistakenly
  204.           avoids asking you to change disks.
  205.  
  206.           RUN  -  to  tell  INSTALL to run the program on the same line.
  207.           For both RUN and SWAP, install looks for the file to be run in
  208.           both the source and the destination directories, and  runs  it
  209.           where  it  was  found  with  the  current  directory being the
  210.           destination directory.  This means that it  works  with  self-
  211.           extracting   archive   files   and   software  that  has  been
  212.           installed.  Use the COMMAND command to simply run programs and
  213.           to pass commands to command.com.  If you are running  a  batch
  214.           file, ending  in .BAT, use "COMMAND /C that.BAT".  Use swap if
  215.           you need all but 2K of memory.    The  parser  ignores  ".COM"
  216.           files, so add the .com if you want to RUN or SWAP .com files.
  217.  
  218.           SWAP  -  to  tell INSTALL to SWAP all but 2k of itself to disk
  219.           before running the program given on the same line.
  220.  
  221.           Examples:
  222.           CLEAR
  223.           RUN  some
  224.           SWAP  bigthing # swap all but 2k of the program to disk
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                The Quick & Easy Install manual                 Page 5
  232.  
  233.  
  234.           WAIT to wait for the user to press a key  to  continue.    The
  235.           wait is actually a long delay.
  236.  
  237.           The  best  way  to  learn  how  to  use INSTALL is to study an
  238.           existing script in  the  INSTALL.DBF/DBT  file.  Run  'INSTALL
  239.           EDIT', and compare its actions to the command script. Practise
  240.           with small scripts and work up.  Test your setups.
  241.  
  242.           If  you  use  the  install  program very much to install other
  243.           software, you will notice that the  size  of  the  install.dbt
  244.           file builds  up.    Use  the  ITUNE.EXE  program to retune the
  245.           size.  It will automatically reclaim wasted space.
  246.  
  247.  
  248.           ASP Introduction:
  249.  
  250.           Please also  carefully  read  the  accompanying  SHARE.ASP  or
  251.           SHR_WARE.DOC document.
  252.  
  253.           "This  program  is  produced by a member of the Association of
  254.           Shareware Professionals (ASP). ASP wants to make sure that the
  255.           shareware principle works  for  you.  If  you  are  unable  to
  256.           resolve  a  shareware-related  problem  with  an ASP member by
  257.           contacting the member directly, ASP may be able to  help.  The
  258.           ASP  Ombudsman  can help you resolve a dispute or problem with
  259.           an ASP member, but does  not  provide  technical  support  for
  260.           members'  products.  Please  write to the ASP Ombudsman at 545
  261.           Grover Road, Muskegon, MI 49442 or send a  CompuServe  message
  262.           via CompuServe Mail to ASP Ombudsman 70007,3536."
  263.  
  264.  
  265.           DISTRIBUTION:   This product is the property of P. C Softsmith
  266.           (c) 1991-4.    It  may  be  distributed  freely,  but  it   is
  267.           shareware.   If  you  use  it  to  produce  setup/installs for
  268.           yourself or others, please send a  letter  with  comments  and
  269.           suggestions to  P.  C. Softsmith.  You do not have to register
  270.           TeleShare or  Hands  On  to  include  it  with  your  product.
  271.           However,  you must include this documentation with any and all
  272.           distributions of INSTALL, and you may not charge more than  an
  273.           'industry    standard'    distribution   fee   for   shareware
  274.           distributors.   See  the  "History"  section  below  for  more
  275.           distribution information.
  276.  
  277.           Support:
  278.  
  279.           Please  contact us for TeleShare/Hands ON support and sales at
  280.           P. C.  Softsmith by telephone (604) 433 - 5189 or at Suite 606
  281.           - 6455 Willingdon Avenue, Burnaby, British  Columbia,  Canada,
  282.           V5H 4E4.    Both  registered  and  soon to be registered users
  283.  
  284.  
  285.  
  286.  
  287.  
  288.                The Quick & Easy Install manual                 Page 6
  289.  
  290.  
  291.           currently get the same  support  without  any  arbitrary  time
  292.           limit.
  293.  
  294.           Internet and Compuserve users can also direct email to:
  295.  
  296.           vic_williams@mindlink.bc.ca
  297.  
  298.  
  299.           Your comments  on  the product will be appreciated.  Naturally
  300.           we all might expect ongoing changes in the product.
  301.  
  302.           History:
  303.  
  304.           September, 1994 v 2.6 - still resolving problems with LASTFILE
  305.           and the 3 1/2" and 5 1/4" disk installations.  Removed some
  306.           of the residual Teleshare setup options.
  307.           June, 1994  Version 2.5  --  added the LASTFILE command.
  308.  
  309.           This install is a version of the installation program used  to
  310.           install  the  FORCE  Xbase  compiler  (the  ONLY  native  code
  311.           producing Xbase compiler), with portions  Copyright  (C)  1989
  312.           Sophco Inc.   The terms of the distribution agreement are such
  313.           that this install program may only be distributed with  P.  C.
  314.           Softsmith products.   If you want to distribute it solely with
  315.           your product, please contact us and we will direct you to  the
  316.           appropriate contact people.
  317.  
  318.           In mid July 1993, the script language was added to the install
  319.           program and the version was upgraded from 1 to 2.
  320.  
  321.  
  322.           DISCLAIMER - AGREEMENT
  323.  
  324.           The  documentation and associated software are distributed and
  325.           sold with no warranties, either express or implied,  regarding
  326.           its merchantability or fitness for any particular purpose.  To
  327.           repeat,  the  author  disclaims  all  warranties, expressed or
  328.           implied, including,  without  limitation,  the  warranties  of
  329.           merchantability and  of  fitness  for any purpose.  The author
  330.           assumes no liability for damages, direct or  conse-  quential,
  331.           which  may  result from the use of the product with or without
  332.           registration.
  333.  
  334.           The information in this documentation  is  subject  to  change
  335.           without  notice  and  does  not represent a committment on the
  336.           part of the vendor.
  337.  
  338.  
  339.           THE DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED  AND
  340.  
  341.  
  342.  
  343.  
  344.  
  345.                The Quick & Easy Install manual                 Page 7
  346.  
  347.  
  348.           SOLD  WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING
  349.           ITS MERCHANTABILITY OR FITNESS  FOR  ANY  PARTICULAR  PURPOSE.
  350.           THE  INFORMATION  IN  THIS  DOCUMENTATION IS SUBJECT TO CHANGE
  351.           WITHOUT NOTICE AND DOES NOT REPRESENT  A  COMMITTMENT  ON  THE
  352.           PART OF THE VENDOR.
  353.  
  354.           OTHER  PRODUCT  AND  BRAND  NAMES  MENTIONED ARE TRADEMARKS OR
  355.           REGISTERED   TRADEMARKS   OF   THEIR    RESPECTIVE    HOLDERS.
  356.           SPECIFICALLY   XBASE   IS   THE   GENERIC   DATABASE  INDUSTRY
  357.           REPLACEMENT FOR THE REGISTERED TERM 'DBASE' OWNED  BY  BORLAND
  358.           INTERNATIONAL.
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.